home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / c / pak.doc < prev    next >
Text File  |  1995-02-13  |  3KB  |  108 lines
  1. *** PAK Documentation ***
  2.  
  3. File PAKer 1.0 - November 2, 1987
  4. Copyright 1987 by Mark Riley
  5. All rights reserved.
  6.  
  7. *** Information ***
  8.  
  9. PAK is a utility for combining and compressing several smaller files into
  10. one large file.  The PAKed file may then be uploaded to a BBS or another
  11. computer.  Transmission time is reduced because PAKed files are compressed.
  12. Also, the receiving party does *not* require any special program to unPAK
  13. the files - PAKed files unPAK themselves!  Unlike other utilities of its
  14. type, PAK imposes no restrictions on filenames.  PAK's small size (under
  15. 5K) makes it handier than those written in high-level languages (PAK is
  16. written in 68000 Assembly Language.)  PAK is simple to use, so have fun!
  17.  
  18. This program is ShareWare; it isn't free.  If you like it (or use it) please
  19. send a $10 contribution to the following address:
  20.  
  21. Mark Riley - Pak
  22. P.O. Box 234
  23. Simi Valley, CA 93062
  24.  
  25. Thank you!  This contribution will help me to provide further low cost
  26. utilities for the Amiga (I've already got several queued up.)
  27.  
  28. You may freely redistribute PAK in its original unaltered state.  If you
  29. have any questions or comments, I can be reached at the above address or
  30. the following services:
  31.  
  32. BIX: mriley - PLINK: (SONIX)
  33.  
  34. *** PAKing Files ***
  35.  
  36. PAK is simple to use.  You may want to install it into your "c:" directory
  37. before you use it though.  This way it'll be there no matter which 
  38. directory you move to.  BTW, PAK works from the CLI only.
  39.  
  40. Usage: PAK master[.PAK] file [file...]
  41.  
  42. The first parameter is the pathname for the master file.  This is
  43. followed by one or more pathnames for the files you want to PAK together.
  44. Files are compressed and added to the master file in the order specified.
  45. Only the name of the files are stored in the master file (not the complete
  46. pathname.)  Also, the default extension ".pak" is added to the master
  47. pathname if not already present.  You may need to explicitly add ".pak"
  48. to the master pathname if you have a file with the same name (minus the
  49. ".pak")
  50.  
  51. Once you've created a PAK file you may add more files to it by simply
  52. using it as the master name again.  If you want to start from scratch,
  53. delete the master file first.
  54.  
  55. PAK files are created in multiples of 1K.  This facilitates their use
  56. with either XMODEM or YMODEM since no chopping is required.
  57.  
  58. Example:
  59.  
  60. 1> dir
  61.   Display              Picture
  62.   ReadMe
  63. 1> pak Test readme display picture
  64. ReadMe...PAKed
  65. Display...PAKed
  66. Picture...PAKed
  67. 1> 
  68.  
  69. *** Displaying PAKed Files ***
  70.  
  71. Usage: PAK master[.PAK]
  72.  
  73. If the master pathname is specified alone, then PAK will display the files
  74. in that master file, along with the original and compressed file sizes.
  75.  
  76. Example:
  77.  
  78. 1> pak test
  79. SIZE   PAKed  FILENAME
  80. ------ ------ --------
  81. 239    202    ReadMe
  82. 2456   1924   Display
  83. 33724  25776  Picture
  84. 1>
  85.  
  86. *** UnPAKing Files ***
  87.  
  88. This is the easy part!  You've already done it when you unPAKed this file.
  89. All you need to do is run the PAKed file.  I suggest that you move it to
  90. an empty directory, as it'll overwrite any files with similar names.
  91.  
  92. When uploading PAKed files to a BBS, explain in the description that all
  93. the user has to do is type the filename from the CLI to unPAK it.  Also,
  94. make sure that you use the ".pak" extension (this is the default) so that
  95. this becomes standard and explanations won't be necessary in the future.
  96.  
  97. Example:
  98.  
  99. 1> dir
  100.   Test.pak
  101. 1> test.pak
  102. 1> dir
  103.   Test.pak             ReadMe
  104.   Display              Picture
  105. 1>
  106.  
  107. *** End of File ***
  108.